/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Doc / libstring.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d Module| \sectco|
|00000020| 64 65 7b 73 74 72 69 6e | 67 7d 7d 0d 0d 5c 73 74 |de{strin|g}}..\st|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 73 74 72 69 6e 67 7d |modindex|{string}|
|00000040| 0d 0d 54 68 69 73 20 6d | 6f 64 75 6c 65 20 64 65 |..This m|odule de|
|00000050| 66 69 6e 65 73 20 73 6f | 6d 65 20 63 6f 6e 73 74 |fines so|me const|
|00000060| 61 6e 74 73 20 75 73 65 | 66 75 6c 20 66 6f 72 20 |ants use|ful for |
|00000070| 63 68 65 63 6b 69 6e 67 | 20 63 68 61 72 61 63 74 |checking| charact|
|00000080| 65 72 0d 63 6c 61 73 73 | 65 73 2c 20 73 6f 6d 65 |er.class|es, some|
|00000090| 20 65 78 63 65 70 74 69 | 6f 6e 73 2c 20 61 6e 64 | excepti|ons, and|
|000000a0| 20 73 6f 6d 65 20 75 73 | 65 66 75 6c 20 73 74 72 | some us|eful str|
|000000b0| 69 6e 67 20 66 75 6e 63 | 74 69 6f 6e 73 2e 0d 54 |ing func|tions..T|
|000000c0| 68 65 20 63 6f 6e 73 74 | 61 6e 74 73 20 61 72 65 |he const|ants are|
|000000d0| 3a 0d 0d 5c 72 65 6e 65 | 77 63 6f 6d 6d 61 6e 64 |:..\rene|wcommand|
|000000e0| 7b 5c 69 6e 64 65 78 73 | 75 62 69 74 65 6d 7d 7b |{\indexs|ubitem}{|
|000000f0| 28 64 61 74 61 20 69 6e | 20 6d 6f 64 75 6c 65 20 |(data in| module |
|00000100| 73 74 72 69 6e 67 29 7d | 0d 5c 62 65 67 69 6e 7b |string)}|.\begin{|
|00000110| 64 61 74 61 64 65 73 63 | 7d 7b 64 69 67 69 74 73 |datadesc|}{digits|
|00000120| 7d 0d 20 20 54 68 65 20 | 73 74 72 69 6e 67 20 5c |}.  The |string \|
|00000130| 63 6f 64 65 7b 27 30 31 | 32 33 34 35 36 37 38 39 |code{'01|23456789|
|00000140| 27 7d 2e 0d 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 |'}..\end|{datades|
|00000150| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|00000160| 65 73 63 7d 7b 68 65 78 | 64 69 67 69 74 73 7d 0d |esc}{hex|digits}.|
|00000170| 20 20 54 68 65 20 73 74 | 72 69 6e 67 20 5c 63 6f |  The st|ring \co|
|00000180| 64 65 7b 27 30 31 32 33 | 34 35 36 37 38 39 61 62 |de{'0123|456789ab|
|00000190| 63 64 65 66 41 42 43 44 | 45 46 27 7d 2e 0d 5c 65 |cdefABCD|EF'}..\e|
|000001a0| 6e 64 7b 64 61 74 61 64 | 65 73 63 7d 0d 0d 5c 62 |nd{datad|esc}..\b|
|000001b0| 65 67 69 6e 7b 64 61 74 | 61 64 65 73 63 7d 7b 6c |egin{dat|adesc}{l|
|000001c0| 65 74 74 65 72 73 7d 0d | 20 20 54 68 65 20 63 6f |etters}.|  The co|
|000001d0| 6e 63 61 74 65 6e 61 74 | 69 6f 6e 20 6f 66 20 74 |ncatenat|ion of t|
|000001e0| 68 65 20 73 74 72 69 6e | 67 73 20 5c 63 6f 64 65 |he strin|gs \code|
|000001f0| 7b 6c 6f 77 65 72 63 61 | 73 65 7d 20 61 6e 64 0d |{lowerca|se} and.|
|00000200| 20 20 5c 63 6f 64 65 7b | 75 70 70 65 72 63 61 73 |  \code{|uppercas|
|00000210| 65 7d 20 64 65 73 63 72 | 69 62 65 64 20 62 65 6c |e} descr|ibed bel|
|00000220| 6f 77 2e 0d 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 |ow..\end|{datades|
|00000230| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|00000240| 65 73 63 7d 7b 6c 6f 77 | 65 72 63 61 73 65 7d 0d |esc}{low|ercase}.|
|00000250| 20 20 41 20 73 74 72 69 | 6e 67 20 63 6f 6e 74 61 |  A stri|ng conta|
|00000260| 69 6e 69 6e 67 20 61 6c | 6c 20 74 68 65 20 63 68 |ining al|l the ch|
|00000270| 61 72 61 63 74 65 72 73 | 20 74 68 61 74 20 61 72 |aracters| that ar|
|00000280| 65 20 63 6f 6e 73 69 64 | 65 72 65 64 20 6c 6f 77 |e consid|ered low|
|00000290| 65 72 63 61 73 65 0d 20 | 20 6c 65 74 74 65 72 73 |ercase. | letters|
|000002a0| 2e 20 20 4f 6e 20 6d 6f | 73 74 20 73 79 73 74 65 |.  On mo|st syste|
|000002b0| 6d 73 20 74 68 69 73 20 | 69 73 20 74 68 65 20 73 |ms this |is the s|
|000002c0| 74 72 69 6e 67 0d 20 20 | 5c 63 6f 64 65 7b 27 61 |tring.  |\code{'a|
|000002d0| 62 63 64 65 66 67 68 69 | 6a 6b 6c 6d 6e 6f 70 71 |bcdefghi|jklmnopq|
|000002e0| 72 73 74 75 76 77 78 79 | 7a 27 7d 2e 20 20 44 6f |rstuvwxy|z'}.  Do|
|000002f0| 20 6e 6f 74 20 63 68 61 | 6e 67 65 20 69 74 73 20 | not cha|nge its |
|00000300| 64 65 66 69 6e 69 74 69 | 6f 6e 20 2d 2d 0d 20 20 |definiti|on --.  |
|00000310| 74 68 65 20 65 66 66 65 | 63 74 20 6f 6e 20 74 68 |the effe|ct on th|
|00000320| 65 20 72 6f 75 74 69 6e | 65 73 20 5c 63 6f 64 65 |e routin|es \code|
|00000330| 7b 75 70 70 65 72 7d 20 | 61 6e 64 20 5c 63 6f 64 |{upper} |and \cod|
|00000340| 65 7b 73 77 61 70 63 61 | 73 65 7d 20 69 73 0d 20 |e{swapca|se} is. |
|00000350| 20 75 6e 64 65 66 69 6e | 65 64 2e 0d 5c 65 6e 64 | undefin|ed..\end|
|00000360| 7b 64 61 74 61 64 65 73 | 63 7d 0d 0d 5c 62 65 67 |{datades|c}..\beg|
|00000370| 69 6e 7b 64 61 74 61 64 | 65 73 63 7d 7b 6f 63 74 |in{datad|esc}{oct|
|00000380| 64 69 67 69 74 73 7d 0d | 20 20 54 68 65 20 73 74 |digits}.|  The st|
|00000390| 72 69 6e 67 20 5c 63 6f | 64 65 7b 27 30 31 32 33 |ring \co|de{'0123|
|000003a0| 34 35 36 37 27 7d 2e 0d | 5c 65 6e 64 7b 64 61 74 |4567'}..|\end{dat|
|000003b0| 61 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 64 |adesc}..|\begin{d|
|000003c0| 61 74 61 64 65 73 63 7d | 7b 75 70 70 65 72 63 61 |atadesc}|{upperca|
|000003d0| 73 65 7d 0d 20 20 41 20 | 73 74 72 69 6e 67 20 63 |se}.  A |string c|
|000003e0| 6f 6e 74 61 69 6e 69 6e | 67 20 61 6c 6c 20 74 68 |ontainin|g all th|
|000003f0| 65 20 63 68 61 72 61 63 | 74 65 72 73 20 74 68 61 |e charac|ters tha|
|00000400| 74 20 61 72 65 20 63 6f | 6e 73 69 64 65 72 65 64 |t are co|nsidered|
|00000410| 20 75 70 70 65 72 63 61 | 73 65 0d 20 20 6c 65 74 | upperca|se.  let|
|00000420| 74 65 72 73 2e 20 20 4f | 6e 20 6d 6f 73 74 20 73 |ters.  O|n most s|
|00000430| 79 73 74 65 6d 73 20 74 | 68 69 73 20 69 73 20 74 |ystems t|his is t|
|00000440| 68 65 20 73 74 72 69 6e | 67 0d 20 20 5c 63 6f 64 |he strin|g.  \cod|
|00000450| 65 7b 27 41 42 43 44 45 | 46 47 48 49 4a 4b 4c 4d |e{'ABCDE|FGHIJKLM|
|00000460| 4e 4f 50 51 52 53 54 55 | 56 57 58 59 5a 27 7d 2e |NOPQRSTU|VWXYZ'}.|
|00000470| 20 20 44 6f 20 6e 6f 74 | 20 63 68 61 6e 67 65 20 |  Do not| change |
|00000480| 69 74 73 20 64 65 66 69 | 6e 69 74 69 6f 6e 20 2d |its defi|nition -|
|00000490| 2d 0d 20 20 74 68 65 20 | 65 66 66 65 63 74 20 6f |-.  the |effect o|
|000004a0| 6e 20 74 68 65 20 72 6f | 75 74 69 6e 65 73 20 5c |n the ro|utines \|
|000004b0| 63 6f 64 65 7b 6c 6f 77 | 65 72 7d 20 61 6e 64 20 |code{low|er} and |
|000004c0| 5c 63 6f 64 65 7b 73 77 | 61 70 63 61 73 65 7d 20 |\code{sw|apcase} |
|000004d0| 69 73 0d 20 20 75 6e 64 | 65 66 69 6e 65 64 2e 0d |is.  und|efined..|
|000004e0| 5c 65 6e 64 7b 64 61 74 | 61 64 65 73 63 7d 0d 0d |\end{dat|adesc}..|
|000004f0| 5c 62 65 67 69 6e 7b 64 | 61 74 61 64 65 73 63 7d |\begin{d|atadesc}|
|00000500| 7b 77 68 69 74 65 73 70 | 61 63 65 7d 0d 20 20 41 |{whitesp|ace}.  A|
|00000510| 20 73 74 72 69 6e 67 20 | 63 6f 6e 74 61 69 6e 69 | string |containi|
|00000520| 6e 67 20 61 6c 6c 20 63 | 68 61 72 61 63 74 65 72 |ng all c|haracter|
|00000530| 73 20 74 68 61 74 20 61 | 72 65 20 63 6f 6e 73 69 |s that a|re consi|
|00000540| 64 65 72 65 64 20 77 68 | 69 74 65 73 70 61 63 65 |dered wh|itespace|
|00000550| 2e 0d 20 20 4f 6e 20 6d | 6f 73 74 20 73 79 73 74 |..  On m|ost syst|
|00000560| 65 6d 73 20 74 68 69 73 | 20 69 6e 63 6c 75 64 65 |ems this| include|
|00000570| 73 20 74 68 65 20 63 68 | 61 72 61 63 74 65 72 73 |s the ch|aracters|
|00000580| 20 73 70 61 63 65 2c 20 | 74 61 62 2c 20 6c 69 6e | space, |tab, lin|
|00000590| 65 66 65 65 64 2c 0d 20 | 20 72 65 74 75 72 6e 2c |efeed,. | return,|
|000005a0| 20 66 6f 72 6d 66 65 65 | 64 2c 20 61 6e 64 20 76 | formfee|d, and v|
|000005b0| 65 72 74 69 63 61 6c 20 | 74 61 62 2e 20 20 44 6f |ertical |tab.  Do|
|000005c0| 20 6e 6f 74 20 63 68 61 | 6e 67 65 20 69 74 73 20 | not cha|nge its |
|000005d0| 64 65 66 69 6e 69 74 69 | 6f 6e 20 2d 2d 0d 20 20 |definiti|on --.  |
|000005e0| 74 68 65 20 65 66 66 65 | 63 74 20 6f 6e 20 74 68 |the effe|ct on th|
|000005f0| 65 20 72 6f 75 74 69 6e | 65 73 20 5c 63 6f 64 65 |e routin|es \code|
|00000600| 7b 73 74 72 69 70 7d 20 | 61 6e 64 20 5c 63 6f 64 |{strip} |and \cod|
|00000610| 65 7b 73 70 6c 69 74 7d | 20 69 73 0d 20 20 75 6e |e{split}| is.  un|
|00000620| 64 65 66 69 6e 65 64 2e | 0d 5c 65 6e 64 7b 64 61 |defined.|.\end{da|
|00000630| 74 61 64 65 73 63 7d 0d | 0d 54 68 65 20 65 78 63 |tadesc}.|.The exc|
|00000640| 65 70 74 69 6f 6e 73 20 | 61 72 65 3a 0d 0d 5c 72 |eptions |are:..\r|
|00000650| 65 6e 65 77 63 6f 6d 6d | 61 6e 64 7b 5c 69 6e 64 |enewcomm|and{\ind|
|00000660| 65 78 73 75 62 69 74 65 | 6d 7d 7b 28 65 78 63 65 |exsubite|m}{(exce|
|00000670| 70 74 69 6f 6e 20 69 6e | 20 6d 6f 64 75 6c 65 20 |ption in| module |
|00000680| 73 74 72 69 6e 67 29 7d | 0d 0d 54 68 65 20 66 75 |string)}|..The fu|
|00000690| 6e 63 74 69 6f 6e 73 20 | 61 72 65 3a 0d 0d 5c 72 |nctions |are:..\r|
|000006a0| 65 6e 65 77 63 6f 6d 6d | 61 6e 64 7b 5c 69 6e 64 |enewcomm|and{\ind|
|000006b0| 65 78 73 75 62 69 74 65 | 6d 7d 7b 28 69 6e 20 6d |exsubite|m}{(in m|
|000006c0| 6f 64 75 6c 65 20 73 74 | 72 69 6e 67 29 7d 0d 0d |odule st|ring)}..|
|000006d0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000006e0| 7b 61 74 6f 66 7d 7b 73 | 7d 0d 43 6f 6e 76 65 72 |{atof}{s|}.Conver|
|000006f0| 74 20 61 20 73 74 72 69 | 6e 67 20 74 6f 20 61 20 |t a stri|ng to a |
|00000700| 66 6c 6f 61 74 69 6e 67 | 20 70 6f 69 6e 74 20 6e |floating| point n|
|00000710| 75 6d 62 65 72 2e 20 20 | 54 68 65 20 73 74 72 69 |umber.  |The stri|
|00000720| 6e 67 20 6d 75 73 74 20 | 68 61 76 65 0d 74 68 65 |ng must |have.the|
|00000730| 20 73 74 61 6e 64 61 72 | 64 20 73 79 6e 74 61 78 | standar|d syntax|
|00000740| 20 66 6f 72 20 61 20 66 | 6c 6f 61 74 69 6e 67 20 | for a f|loating |
|00000750| 70 6f 69 6e 74 20 6c 69 | 74 65 72 61 6c 20 69 6e |point li|teral in|
|00000760| 20 50 79 74 68 6f 6e 2c | 20 6f 70 74 69 6f 6e 61 | Python,| optiona|
|00000770| 6c 6c 79 0d 70 72 65 63 | 65 64 65 64 20 62 79 20 |lly.prec|eded by |
|00000780| 61 20 73 69 67 6e 20 28 | 5c 73 61 6d 70 7b 2b 7d |a sign (|\samp{+}|
|00000790| 20 6f 72 20 5c 73 61 6d | 70 7b 2d 7d 29 2e 0d 5c | or \sam|p{-})..\|
|000007a0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|000007b0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000007c0| 61 74 6f 69 7d 7b 73 7d | 0d 43 6f 6e 76 65 72 74 |atoi}{s}|.Convert|
|000007d0| 20 61 20 73 74 72 69 6e | 67 20 74 6f 20 61 6e 20 | a strin|g to an |
|000007e0| 69 6e 74 65 67 65 72 2e | 20 20 54 68 65 20 73 74 |integer.|  The st|
|000007f0| 72 69 6e 67 20 6d 75 73 | 74 20 63 6f 6e 73 69 73 |ring mus|t consis|
|00000800| 74 20 6f 66 20 6f 6e 65 | 20 6f 72 20 6d 6f 72 65 |t of one| or more|
|00000810| 0d 64 69 67 69 74 73 2c | 20 6f 70 74 69 6f 6e 61 |.digits,| optiona|
|00000820| 6c 6c 79 20 70 72 65 63 | 65 64 65 64 20 62 79 20 |lly prec|eded by |
|00000830| 61 20 73 69 67 6e 20 28 | 5c 73 61 6d 70 7b 2b 7d |a sign (|\samp{+}|
|00000840| 20 6f 72 20 5c 73 61 6d | 70 7b 2d 7d 29 2e 0d 5c | or \sam|p{-})..\|
|00000850| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000860| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000870| 61 74 6f 6c 7d 7b 73 7d | 0d 43 6f 6e 76 65 72 74 |atol}{s}|.Convert|
|00000880| 20 61 20 73 74 72 69 6e | 67 20 74 6f 20 61 20 6c | a strin|g to a l|
|00000890| 6f 6e 67 20 69 6e 74 65 | 67 65 72 2e 20 20 54 68 |ong inte|ger.  Th|
|000008a0| 65 20 73 74 72 69 6e 67 | 20 6d 75 73 74 20 63 6f |e string| must co|
|000008b0| 6e 73 69 73 74 20 6f 66 | 20 6f 6e 65 0d 6f 72 20 |nsist of| one.or |
|000008c0| 6d 6f 72 65 20 64 69 67 | 69 74 73 2c 20 6f 70 74 |more dig|its, opt|
|000008d0| 69 6f 6e 61 6c 6c 79 20 | 70 72 65 63 65 64 65 64 |ionally |preceded|
|000008e0| 20 62 79 20 61 20 73 69 | 67 6e 20 28 5c 73 61 6d | by a si|gn (\sam|
|000008f0| 70 7b 2b 7d 20 6f 72 20 | 5c 73 61 6d 70 7b 2d 7d |p{+} or |\samp{-}|
|00000900| 29 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |)..\end{|funcdesc|
|00000910| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000920| 73 63 7d 7b 65 78 70 61 | 6e 64 74 61 62 73 7d 7b |sc}{expa|ndtabs}{|
|00000930| 73 5c 2c 20 74 61 62 73 | 69 7a 65 7d 0d 45 78 70 |s\, tabs|ize}.Exp|
|00000940| 61 6e 64 20 74 61 62 73 | 20 69 6e 20 61 20 73 74 |and tabs| in a st|
|00000950| 72 69 6e 67 2c 20 69 2e | 65 2e 20 72 65 70 6c 61 |ring, i.|e. repla|
|00000960| 63 65 20 74 68 65 6d 20 | 62 79 20 6f 6e 65 20 6f |ce them |by one o|
|00000970| 72 20 6d 6f 72 65 20 73 | 70 61 63 65 73 2c 0d 64 |r more s|paces,.d|
|00000980| 65 70 65 6e 64 69 6e 67 | 20 6f 6e 20 74 68 65 20 |epending| on the |
|00000990| 63 75 72 72 65 6e 74 20 | 63 6f 6c 75 6d 6e 20 61 |current |column a|
|000009a0| 6e 64 20 74 68 65 20 67 | 69 76 65 6e 20 74 61 62 |nd the g|iven tab|
|000009b0| 20 73 69 7a 65 2e 20 20 | 54 68 65 20 63 6f 6c 75 | size.  |The colu|
|000009c0| 6d 6e 0d 6e 75 6d 62 65 | 72 20 69 73 20 72 65 73 |mn.numbe|r is res|
|000009d0| 65 74 20 74 6f 20 7a 65 | 72 6f 20 61 66 74 65 72 |et to ze|ro after|
|000009e0| 20 65 61 63 68 20 6e 65 | 77 6c 69 6e 65 20 6f 63 | each ne|wline oc|
|000009f0| 63 75 72 72 69 6e 67 20 | 69 6e 20 74 68 65 20 73 |curring |in the s|
|00000a00| 74 72 69 6e 67 2e 0d 54 | 68 69 73 20 64 6f 65 73 |tring..T|his does|
|00000a10| 6e 27 74 20 75 6e 64 65 | 72 73 74 61 6e 64 20 6f |n't unde|rstand o|
|00000a20| 74 68 65 72 20 6e 6f 6e | 2d 70 72 69 6e 74 69 6e |ther non|-printin|
|00000a30| 67 20 63 68 61 72 61 63 | 74 65 72 73 20 6f 72 20 |g charac|ters or |
|00000a40| 65 73 63 61 70 65 0d 73 | 65 71 75 65 6e 63 65 73 |escape.s|equences|
|00000a50| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000a60| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000a70| 63 7d 7b 66 69 6e 64 7d | 7b 73 5c 2c 20 73 75 62 |c}{find}|{s\, sub|
|00000a80| 5c 6f 70 74 69 6f 6e 61 | 6c 7b 5c 2c 20 73 74 61 |\optiona|l{\, sta|
|00000a90| 72 74 7d 7d 0d 52 65 74 | 75 72 6e 20 74 68 65 20 |rt}}.Ret|urn the |
|00000aa0| 6c 6f 77 65 73 74 20 69 | 6e 64 65 78 20 69 6e 20 |lowest i|ndex in |
|00000ab0| 5c 76 61 72 7b 73 7d 20 | 6e 6f 74 20 73 6d 61 6c |\var{s} |not smal|
|00000ac0| 6c 65 72 20 74 68 61 6e | 20 5c 76 61 72 7b 73 74 |ler than| \var{st|
|00000ad0| 61 72 74 7d 20 77 68 65 | 72 65 20 74 68 65 0d 73 |art} whe|re the.s|
|00000ae0| 75 62 73 74 72 69 6e 67 | 20 5c 76 61 72 7b 73 75 |ubstring| \var{su|
|00000af0| 62 7d 20 69 73 20 66 6f | 75 6e 64 2e 20 20 52 65 |b} is fo|und.  Re|
|00000b00| 74 75 72 6e 20 5c 63 6f | 64 65 7b 2d 31 7d 20 77 |turn \co|de{-1} w|
|00000b10| 68 65 6e 20 5c 76 61 72 | 7b 73 75 62 7d 0d 64 6f |hen \var|{sub}.do|
|00000b20| 65 73 20 6e 6f 74 20 6f | 63 63 75 72 20 61 73 20 |es not o|ccur as |
|00000b30| 61 20 73 75 62 73 74 72 | 69 6e 67 20 6f 66 20 5c |a substr|ing of \|
|00000b40| 76 61 72 7b 73 7d 20 77 | 69 74 68 20 69 6e 64 65 |var{s} w|ith inde|
|00000b50| 78 20 61 74 20 6c 65 61 | 73 74 20 5c 76 61 72 7b |x at lea|st \var{|
|00000b60| 73 74 61 72 74 7d 2e 0d | 49 66 20 5c 76 61 72 7b |start}..|If \var{|
|00000b70| 73 74 61 72 74 7d 20 69 | 73 20 6f 6d 69 74 74 65 |start} i|s omitte|
|00000b80| 64 2c 20 69 74 20 64 65 | 66 61 75 6c 74 73 20 74 |d, it de|faults t|
|00000b90| 6f 20 5c 63 6f 64 65 7b | 30 7d 2e 20 20 49 66 20 |o \code{|0}.  If |
|00000ba0| 5c 76 61 72 7b 73 74 61 | 72 74 7d 20 69 73 0d 6e |\var{sta|rt} is.n|
|00000bb0| 65 67 61 74 69 76 65 2c | 20 5c 63 6f 64 65 7b 6c |egative,| \code{l|
|00000bc0| 65 6e 28 5c 76 61 72 7b | 73 7d 29 7d 20 69 73 20 |en(\var{|s})} is |
|00000bd0| 61 64 64 65 64 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |added..\|end{func|
|00000be0| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000bf0| 6e 63 64 65 73 63 7d 7b | 72 66 69 6e 64 7d 7b 73 |ncdesc}{|rfind}{s|
|00000c00| 5c 2c 20 73 75 62 5c 6f | 70 74 69 6f 6e 61 6c 7b |\, sub\o|ptional{|
|00000c10| 5c 2c 20 73 74 61 72 74 | 7d 7d 0d 4c 69 6b 65 20 |\, start|}}.Like |
|00000c20| 5c 63 6f 64 65 7b 66 69 | 6e 64 7d 20 62 75 74 20 |\code{fi|nd} but |
|00000c30| 66 69 6e 64 73 20 74 68 | 65 20 68 69 67 68 65 73 |finds th|e highes|
|00000c40| 74 20 69 6e 64 65 78 2e | 0d 5c 65 6e 64 7b 66 75 |t index.|.\end{fu|
|00000c50| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000c60| 66 75 6e 63 64 65 73 63 | 7d 7b 69 6e 64 65 78 7d |funcdesc|}{index}|
|00000c70| 7b 73 5c 2c 20 73 75 62 | 5c 6f 70 74 69 6f 6e 61 |{s\, sub|\optiona|
|00000c80| 6c 7b 5c 2c 20 73 74 61 | 72 74 7d 7d 0d 4c 69 6b |l{\, sta|rt}}.Lik|
|00000c90| 65 20 5c 63 6f 64 65 7b | 66 69 6e 64 7d 20 62 75 |e \code{|find} bu|
|00000ca0| 74 20 72 61 69 73 65 20 | 5c 63 6f 64 65 7b 56 61 |t raise |\code{Va|
|00000cb0| 6c 75 65 45 72 72 6f 72 | 7d 20 77 68 65 6e 20 74 |lueError|} when t|
|00000cc0| 68 65 20 73 75 62 73 74 | 72 69 6e 67 20 69 73 0d |he subst|ring is.|
|00000cd0| 6e 6f 74 20 66 6f 75 6e | 64 2e 0d 5c 65 6e 64 7b |not foun|d..\end{|
|00000ce0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000cf0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 72 69 6e 64 |n{funcde|sc}{rind|
|00000d00| 65 78 7d 7b 73 5c 2c 20 | 73 75 62 5c 6f 70 74 69 |ex}{s\, |sub\opti|
|00000d10| 6f 6e 61 6c 7b 5c 2c 20 | 73 74 61 72 74 7d 7d 0d |onal{\, |start}}.|
|00000d20| 4c 69 6b 65 20 5c 63 6f | 64 65 7b 72 66 69 6e 64 |Like \co|de{rfind|
|00000d30| 7d 20 62 75 74 20 72 61 | 69 73 65 20 5c 63 6f 64 |} but ra|ise \cod|
|00000d40| 65 7b 56 61 6c 75 65 45 | 72 72 6f 72 7d 20 77 68 |e{ValueE|rror} wh|
|00000d50| 65 6e 20 74 68 65 20 73 | 75 62 73 74 72 69 6e 67 |en the s|ubstring|
|00000d60| 20 69 73 0d 6e 6f 74 20 | 66 6f 75 6e 64 2e 0d 5c | is.not |found..\|
|00000d70| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000d80| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000d90| 63 6f 75 6e 74 7d 7b 73 | 5c 2c 20 73 75 62 5c 2c |count}{s|\, sub\,|
|00000da0| 20 69 7d 0d 52 65 74 75 | 72 6e 20 74 68 65 20 6e | i}.Retu|rn the n|
|00000db0| 75 6d 62 65 72 20 6f 66 | 20 28 6e 6f 6e 2d 6f 76 |umber of| (non-ov|
|00000dc0| 65 72 6c 61 70 70 69 6e | 67 29 20 6f 63 63 75 72 |erlappin|g) occur|
|00000dd0| 72 65 6e 63 65 73 20 6f | 66 20 73 75 62 73 74 72 |rences o|f substr|
|00000de0| 69 6e 67 0d 5c 76 61 72 | 7b 73 75 62 7d 20 69 6e |ing.\var|{sub} in|
|00000df0| 20 73 74 72 69 6e 67 20 | 5c 76 61 72 7b 73 7d 20 | string |\var{s} |
|00000e00| 77 69 74 68 20 69 6e 64 | 65 78 20 61 74 20 6c 65 |with ind|ex at le|
|00000e10| 61 73 74 20 5c 76 61 72 | 7b 69 7d 2e 0d 49 66 20 |ast \var|{i}..If |
|00000e20| 5c 76 61 72 7b 69 7d 20 | 69 73 20 6f 6d 69 74 74 |\var{i} |is omitt|
|00000e30| 65 64 2c 20 69 74 20 64 | 65 66 61 75 6c 74 73 20 |ed, it d|efaults |
|00000e40| 74 6f 20 5c 63 6f 64 65 | 7b 30 7d 2e 0d 5c 65 6e |to \code|{0}..\en|
|00000e50| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000e60| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 6c 6f |gin{func|desc}{lo|
|00000e70| 77 65 72 7d 7b 73 7d 0d | 43 6f 6e 76 65 72 74 20 |wer}{s}.|Convert |
|00000e80| 6c 65 74 74 65 72 73 20 | 74 6f 20 6c 6f 77 65 72 |letters |to lower|
|00000e90| 20 63 61 73 65 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 | case..\|end{func|
|00000ea0| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000eb0| 6e 63 64 65 73 63 7d 7b | 73 70 6c 69 74 7d 7b 73 |ncdesc}{|split}{s|
|00000ec0| 7d 0d 52 65 74 75 72 6e | 73 20 61 20 6c 69 73 74 |}.Return|s a list|
|00000ed0| 20 6f 66 20 74 68 65 20 | 77 68 69 74 65 73 70 61 | of the |whitespa|
|00000ee0| 63 65 2d 64 65 6c 69 6d | 69 74 65 64 20 77 6f 72 |ce-delim|ited wor|
|00000ef0| 64 73 20 6f 66 20 74 68 | 65 20 73 74 72 69 6e 67 |ds of th|e string|
|00000f00| 0d 5c 76 61 72 7b 73 7d | 2e 0d 5c 65 6e 64 7b 66 |.\var{s}|..\end{f|
|00000f10| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000f20| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 73 70 6c 69 74 |{funcdes|c}{split|
|00000f30| 66 69 65 6c 64 73 7d 7b | 73 5c 2c 20 73 65 70 7d |fields}{|s\, sep}|
|00000f40| 0d 20 20 52 65 74 75 72 | 6e 73 20 61 20 6c 69 73 |.  Retur|ns a lis|
|00000f50| 74 20 63 6f 6e 74 61 69 | 6e 69 6e 67 20 74 68 65 |t contai|ning the|
|00000f60| 20 66 69 65 6c 64 73 20 | 6f 66 20 74 68 65 20 73 | fields |of the s|
|00000f70| 74 72 69 6e 67 20 5c 76 | 61 72 7b 73 7d 2c 20 75 |tring \v|ar{s}, u|
|00000f80| 73 69 6e 67 0d 20 20 74 | 68 65 20 73 74 72 69 6e |sing.  t|he strin|
|00000f90| 67 20 5c 76 61 72 7b 73 | 65 70 7d 20 61 73 20 61 |g \var{s|ep} as a|
|00000fa0| 20 73 65 70 61 72 61 74 | 6f 72 2e 20 20 54 68 65 | separat|or.  The|
|00000fb0| 20 6c 69 73 74 20 77 69 | 6c 6c 20 68 61 76 65 20 | list wi|ll have |
|00000fc0| 6f 6e 65 20 6d 6f 72 65 | 0d 20 20 69 74 65 6d 73 |one more|.  items|
|00000fd0| 20 74 68 61 6e 20 74 68 | 65 20 6e 75 6d 62 65 72 | than th|e number|
|00000fe0| 20 6f 66 20 6e 6f 6e 2d | 6f 76 65 72 6c 61 70 70 | of non-|overlapp|
|00000ff0| 69 6e 67 20 6f 63 63 75 | 72 72 65 6e 63 65 73 20 |ing occu|rrences |
|00001000| 6f 66 20 74 68 65 0d 20 | 20 73 65 70 61 72 61 74 |of the. | separat|
|00001010| 6f 72 20 69 6e 20 74 68 | 65 20 73 74 72 69 6e 67 |or in th|e string|
|00001020| 2e 20 20 54 68 75 73 2c | 20 5c 63 6f 64 65 7b 73 |.  Thus,| \code{s|
|00001030| 74 72 69 6e 67 2e 73 70 | 6c 69 74 66 69 65 6c 64 |tring.sp|litfield|
|00001040| 73 28 5c 76 61 72 7b 73 | 7d 2c 20 27 0d 20 20 27 |s(\var{s|}, '.  '|
|00001050| 29 7d 20 69 73 20 6e 6f | 74 20 74 68 65 20 73 61 |)} is no|t the sa|
|00001060| 6d 65 20 61 73 20 5c 63 | 6f 64 65 7b 73 74 72 69 |me as \c|ode{stri|
|00001070| 6e 67 2e 73 70 6c 69 74 | 28 5c 76 61 72 7b 73 7d |ng.split|(\var{s}|
|00001080| 29 7d 2c 20 61 73 20 74 | 68 65 20 6c 61 74 74 65 |)}, as t|he latte|
|00001090| 72 0d 20 20 6f 6e 6c 79 | 20 72 65 74 75 72 6e 73 |r.  only| returns|
|000010a0| 20 6e 6f 6e 2d 65 6d 70 | 74 79 20 77 6f 72 64 73 | non-emp|ty words|
|000010b0| 2e 20 20 41 73 20 61 20 | 73 70 65 63 69 61 6c 20 |.  As a |special |
|000010c0| 63 61 73 65 2c 0d 20 20 | 5c 63 6f 64 65 7b 73 70 |case,.  |\code{sp|
|000010d0| 6c 69 74 66 69 65 6c 64 | 73 28 5c 76 61 72 7b 73 |litfield|s(\var{s|
|000010e0| 7d 2c 20 27 27 29 7d 20 | 72 65 74 75 72 6e 73 20 |}, '')} |returns |
|000010f0| 5c 63 6f 64 65 7b 5b 5c | 76 61 72 7b 73 7d 5d 7d |\code{[\|var{s}]}|
|00001100| 2c 20 66 6f 72 20 61 6e | 79 20 73 74 72 69 6e 67 |, for an|y string|
|00001110| 0d 20 20 5c 76 61 72 7b | 73 7d 2e 20 20 28 53 65 |.  \var{|s}.  (Se|
|00001120| 65 20 61 6c 73 6f 20 5c | 63 6f 64 65 7b 72 65 67 |e also \|code{reg|
|00001130| 73 75 62 2e 73 70 6c 69 | 74 28 29 7d 2e 29 0d 5c |sub.spli|t()}.).\|
|00001140| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00001150| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001160| 6a 6f 69 6e 7d 7b 77 6f | 72 64 73 7d 0d 43 6f 6e |join}{wo|rds}.Con|
|00001170| 63 61 74 65 6e 61 74 65 | 20 61 20 6c 69 73 74 20 |catenate| a list |
|00001180| 6f 72 20 74 75 70 6c 65 | 20 6f 66 20 77 6f 72 64 |or tuple| of word|
|00001190| 73 20 77 69 74 68 20 69 | 6e 74 65 72 76 65 6e 69 |s with i|nterveni|
|000011a0| 6e 67 20 73 70 61 63 65 | 73 2e 0d 5c 65 6e 64 7b |ng space|s..\end{|
|000011b0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|000011c0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 6a 6f 69 6e |n{funcde|sc}{join|
|000011d0| 66 69 65 6c 64 73 7d 7b | 77 6f 72 64 73 5c 2c 20 |fields}{|words\, |
|000011e0| 73 65 70 7d 0d 43 6f 6e | 63 61 74 65 6e 61 74 65 |sep}.Con|catenate|
|000011f0| 20 61 20 6c 69 73 74 20 | 6f 72 20 74 75 70 6c 65 | a list |or tuple|
|00001200| 20 6f 66 20 77 6f 72 64 | 73 20 77 69 74 68 20 69 | of word|s with i|
|00001210| 6e 74 65 72 76 65 6e 69 | 6e 67 20 73 65 70 61 72 |nterveni|ng separ|
|00001220| 61 74 6f 72 73 2e 0d 49 | 74 20 69 73 20 61 6c 77 |ators..I|t is alw|
|00001230| 61 79 73 20 74 72 75 65 | 20 74 68 61 74 0d 5c 63 |ays true| that.\c|
|00001240| 6f 64 65 7b 73 74 72 69 | 6e 67 2e 6a 6f 69 6e 66 |ode{stri|ng.joinf|
|00001250| 69 65 6c 64 73 28 73 74 | 72 69 6e 67 2e 73 70 6c |ields(st|ring.spl|
|00001260| 69 74 66 69 65 6c 64 73 | 28 5c 76 61 72 7b 74 7d |itfields|(\var{t}|
|00001270| 2c 20 5c 76 61 72 7b 73 | 65 70 7d 29 2c 20 5c 76 |, \var{s|ep}), \v|
|00001280| 61 72 7b 73 65 70 7d 29 | 7d 0d 65 71 75 61 6c 73 |ar{sep})|}.equals|
|00001290| 20 5c 76 61 72 7b 74 7d | 2e 0d 5c 65 6e 64 7b 66 | \var{t}|..\end{f|
|000012a0| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000012b0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 73 74 72 69 70 |{funcdes|c}{strip|
|000012c0| 7d 7b 73 7d 0d 52 65 6d | 6f 76 65 73 20 6c 65 61 |}{s}.Rem|oves lea|
|000012d0| 64 69 6e 67 20 61 6e 64 | 20 74 72 61 69 6c 69 6e |ding and| trailin|
|000012e0| 67 20 77 68 69 74 65 73 | 70 61 63 65 20 66 72 6f |g whites|pace fro|
|000012f0| 6d 20 74 68 65 20 73 74 | 72 69 6e 67 0d 5c 76 61 |m the st|ring.\va|
|00001300| 72 7b 73 7d 2e 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |r{s}..\e|nd{funcd|
|00001310| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00001320| 63 64 65 73 63 7d 7b 73 | 77 61 70 63 61 73 65 7d |cdesc}{s|wapcase}|
|00001330| 7b 73 7d 0d 43 6f 6e 76 | 65 72 74 73 20 6c 6f 77 |{s}.Conv|erts low|
|00001340| 65 72 20 63 61 73 65 20 | 6c 65 74 74 65 72 73 20 |er case |letters |
|00001350| 74 6f 20 75 70 70 65 72 | 20 63 61 73 65 20 61 6e |to upper| case an|
|00001360| 64 20 76 69 63 65 20 76 | 65 72 73 61 2e 0d 5c 65 |d vice v|ersa..\e|
|00001370| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00001380| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 75 |egin{fun|cdesc}{u|
|00001390| 70 70 65 72 7d 7b 73 7d | 0d 43 6f 6e 76 65 72 74 |pper}{s}|.Convert|
|000013a0| 20 6c 65 74 74 65 72 73 | 20 74 6f 20 75 70 70 65 | letters| to uppe|
|000013b0| 72 20 63 61 73 65 2e 0d | 5c 65 6e 64 7b 66 75 6e |r case..|\end{fun|
|000013c0| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|000013d0| 75 6e 63 64 65 73 63 7d | 7b 6c 6a 75 73 74 7d 7b |uncdesc}|{ljust}{|
|000013e0| 73 5c 2c 20 77 69 64 74 | 68 7d 0d 5c 66 75 6e 63 |s\, widt|h}.\func|
|000013f0| 6c 69 6e 65 7b 72 6a 75 | 73 74 7d 7b 73 5c 2c 20 |line{rju|st}{s\, |
|00001400| 77 69 64 74 68 7d 0d 5c | 66 75 6e 63 6c 69 6e 65 |width}.\|funcline|
|00001410| 7b 63 65 6e 74 65 72 7d | 7b 73 5c 2c 20 77 69 64 |{center}|{s\, wid|
|00001420| 74 68 7d 0d 54 68 65 73 | 65 20 66 75 6e 63 74 69 |th}.Thes|e functi|
|00001430| 6f 6e 73 20 72 65 73 70 | 65 63 74 69 76 65 6c 79 |ons resp|ectively|
|00001440| 20 6c 65 66 74 2d 6a 75 | 73 74 69 66 79 2c 20 72 | left-ju|stify, r|
|00001450| 69 67 68 74 2d 6a 75 73 | 74 69 66 79 20 61 6e 64 |ight-jus|tify and|
|00001460| 20 63 65 6e 74 65 72 20 | 61 0d 73 74 72 69 6e 67 | center |a.string|
|00001470| 20 69 6e 20 61 20 66 69 | 65 6c 64 20 6f 66 20 67 | in a fi|eld of g|
|00001480| 69 76 65 6e 20 77 69 64 | 74 68 2e 0d 54 68 65 79 |iven wid|th..They|
|00001490| 20 72 65 74 75 72 6e 20 | 61 20 73 74 72 69 6e 67 | return |a string|
|000014a0| 20 74 68 61 74 20 69 73 | 20 61 74 20 6c 65 61 73 | that is| at leas|
|000014b0| 74 0d 5c 76 61 72 7b 77 | 69 64 74 68 7d 0d 63 68 |t.\var{w|idth}.ch|
|000014c0| 61 72 61 63 74 65 72 73 | 20 77 69 64 65 2c 20 63 |aracters| wide, c|
|000014d0| 72 65 61 74 65 64 20 62 | 79 20 70 61 64 64 69 6e |reated b|y paddin|
|000014e0| 67 20 74 68 65 20 73 74 | 72 69 6e 67 0d 5c 76 61 |g the st|ring.\va|
|000014f0| 72 7b 73 7d 0d 77 69 74 | 68 20 73 70 61 63 65 73 |r{s}.wit|h spaces|
|00001500| 20 75 6e 74 69 6c 20 74 | 68 65 20 67 69 76 65 6e | until t|he given|
|00001510| 20 77 69 64 74 68 20 6f | 6e 20 74 68 65 20 72 69 | width o|n the ri|
|00001520| 67 68 74 2c 20 6c 65 66 | 74 20 6f 72 20 62 6f 74 |ght, lef|t or bot|
|00001530| 68 20 73 69 64 65 73 2e | 0d 54 68 65 20 73 74 72 |h sides.|.The str|
|00001540| 69 6e 67 20 69 73 20 6e | 65 76 65 72 20 74 72 75 |ing is n|ever tru|
|00001550| 6e 63 61 74 65 64 2e 0d | 5c 65 6e 64 7b 66 75 6e |ncated..|\end{fun|
|00001560| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001570| 75 6e 63 64 65 73 63 7d | 7b 7a 66 69 6c 6c 7d 7b |uncdesc}|{zfill}{|
|00001580| 73 5c 2c 20 77 69 64 74 | 68 7d 0d 50 61 64 20 61 |s\, widt|h}.Pad a|
|00001590| 20 6e 75 6d 65 72 69 63 | 20 73 74 72 69 6e 67 20 | numeric| string |
|000015a0| 6f 6e 20 74 68 65 20 6c | 65 66 74 20 77 69 74 68 |on the l|eft with|
|000015b0| 20 7a 65 72 6f 20 64 69 | 67 69 74 73 20 75 6e 74 | zero di|gits unt|
|000015c0| 69 6c 20 74 68 65 20 67 | 69 76 65 6e 0d 77 69 64 |il the g|iven.wid|
|000015d0| 74 68 20 69 73 20 72 65 | 61 63 68 65 64 2e 20 20 |th is re|ached.  |
|000015e0| 53 74 72 69 6e 67 73 20 | 73 74 61 72 74 69 6e 67 |Strings |starting|
|000015f0| 20 77 69 74 68 20 61 20 | 73 69 67 6e 20 61 72 65 | with a |sign are|
|00001600| 20 68 61 6e 64 6c 65 64 | 20 63 6f 72 72 65 63 74 | handled| correct|
|00001610| 6c 79 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ly..\end|{funcdes|
|00001620| 63 7d 0d                |                         |c}.     |        |
+--------+-------------------------+-------------------------+--------+--------+